home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 11 / Cream of the Crop 11-1.iso / editor / censor10.zip / README.TXT < prev   
Text File  |  1995-12-19  |  4KB  |  74 lines
  1. Lally's File Censorer
  2. ==========================
  3.  
  4. This program will go through a specified file and replace any words in this
  5. file that match a word in the dictionary file with asterisks.  Good for
  6. censoring bad words out of slightly profanic files.
  7.  
  8. To Use:
  9.   censor filename [dictionaryfile]
  10. Where:
  11.    filename: the name of the file you want to censor! (the input file)
  12.       Filename can be anything DOS allows & should be plain ASCII text
  13.       (but I haven't tried it with anything else)
  14.    [dictionaryfile]: in brackets cause it's optional.  See below to see
  15.       when you don't need to supply it.  The file contains the words to
  16.       be censored out of the input file.
  17.  
  18. There are basically two files to my censorer system.  These are the
  19. executable and the dictionary.  Now the only thing is that 
  20. the program won't search through the system's path for the dictionary
  21. (it's my compiler, not me).  So what you have to do is either one of
  22. three things to have the  program find the dictionary file:
  23.    1. Have the dictionary file in the current directory
  24.    2. Specify the dictionary's filename in the command line after
  25.       the input file name
  26.    3. Set the CENSOR environment variable to the FULL path & filename
  27.       of the dictionary file.
  28.  
  29. For me, the third is probably the best.  The easiest way is to put
  30. it in your autoexec.bat file.  Just add a line like this to your
  31. autoexec.bat file:
  32. SET CENSOR=C:\DOS\CENSOR.DCT
  33. That is assuming that you have the file in the dos directory.  By the
  34. way, the file doesn't have to be named censor.dct, it's just the name
  35. the program searches for in the current directory if you don't specify
  36. one in the command line.
  37.  
  38. The dictionary file is extremely simple.  It's just a list of bad words.
  39. Just pop in any more that you think should be censored or remove some you
  40. don't want censored.  They don't have to alphabetized or anything! Sorry,
  41. no means for entering comments or any of that fancy stuff, any text found
  42. in the dictionary file will be censored out!  The restrictions are that the
  43. words to be censored can be alphanumeric only.
  44.  
  45. In case you're wondering, I wrote this for two reasons:
  46.    1. So I could show some of my friends some cool text files I get off the
  47.       net without offending some of them
  48.    2. To censor some of my C++ source files, sometimes I comment profanely :)
  49.       (You know how it is after your third bottle JOLT)
  50.  
  51. I wrote it in C++ (with exceptions, classes, & templates for fun) with
  52. BC 4.02 (too poor to buy the latest version :( ).  Spent about three maybe
  53. four 4 hour sessions writing & debugging & rewriting & debugging.
  54.  
  55. Okay, this program here is COMPLETELY FREE OF CHARGE!!!
  56. Use, distribute, & modify this as you wish (good luck w/o the source :)
  57. I'm not responsible for anything that happens because of this program
  58. (unless it's a good thing :).  I basically did it while procrastinating
  59. from doing my History AP homework (still haven't done it & it's been 3 weeks!)
  60.  
  61. Well, Enjoy!
  62.  
  63. Any questions or comments?
  64. =======================================================================
  65. Lally Singh
  66. Male, 16 (case you're wondering)
  67. lsingh@ids2.idsonline.com
  68. =======================================================================
  69. BTW: Don't expect this program to be perfect, I've tested it on some files
  70. ranging from 9K to 155K, seemed to work OKish.  Also, I don't have too much
  71. time to read my email and/or write code cause I have school (Junior Year,
  72. High School) & stuff, so don't be offended if I can't respond for a while
  73. or at all!  I'll try though.
  74.